Keysight Pathwave 89600 VSA .NET API
ChangeLogicalChannels(Int32[]) Method
See Also 
Agilent.SA.Vsa.Interfaces Assembly > Agilent.SA.Vsa Namespace > Input Class > ChangeLogicalChannels Method : ChangeLogicalChannels(Int32[]) Method


channels
The channel numbers that correspond to the desired channels. This is the equivalent of ChannelId with the Group part of it set to the first group.

Glossary Item Box

Changes the input channel configuration for the current measurement by specifying specific input channels using channel numbers with the assumption that all channels are in the first group of instruments for the Measurement.SelectedAnalyzer.

Syntax

Visual Basic (Declaration) 
Public Overloads MustOverride Sub ChangeLogicalChannels( _
   ByVal ParamArray channels() As Integer _
) 
C# 
public abstract void ChangeLogicalChannels( 
   params int[] channels
)
C++/CLI 
public:
abstract void ChangeLogicalChannels( 
   ... array<int>^ channels
) 

Parameters

channels
The channel numbers that correspond to the desired channels. This is the equivalent of ChannelId with the Group part of it set to the first group.

Exceptions

ExceptionDescription
System.ArgumentNullExceptionchannels is null.
System.ArgumentOutOfRangeExceptionchannels is not possible with the currently selected hardware.

Remarks

This method assumes that each of the specified input channels will be used as a logical channel. Internally it uses an instance of LogicalChannelId for each specified input channel with the LogicalChannelOperation set to LogicalChannelOperation.None and each ChannelId instance with ChannelId.Group set to 1 (i.e. all channels assumed to be in the first group of instruments for the currently selected analyzer).

Hardware Interchangeability: Do not use this method if hardware interchangeability is important. A channel identifier is only valid and unique within the context of the model(s) of hardware being used.

Affect on Traces: Undefined. The Measurement.PresetTraces, RemoveExtra, and TraceCollection.ArrangeWindows methods may be useful in presetting traces to a default number, result assignment, and layout after changing the channel configuration.

Requirements

Target Platforms: Windows 11 Professional or Enterprise; Windows 10 Professional, Enterprise, or Education (64-bit)

See Also